Skip to content

Add missing options to dotnet run command documentation#50912

Merged
meaghanlewis merged 6 commits intomainfrom
copilot/add-launch-profile-shortcut
Jan 7, 2026
Merged

Add missing options to dotnet run command documentation#50912
meaghanlewis merged 6 commits intomainfrom
copilot/add-launch-profile-shortcut

Conversation

Copy link
Contributor

Copilot AI commented Jan 6, 2026 •
edited by github-actions bot
Loading

The dotnet run documentation Synopsis was missing several options that exist in the command: the -lp shortcut for --launch-profile, --disable-build-servers, --no-cache, and -sc|--self-contained.

Changes

  • Synopsis section: Added -lp|--launch-profile, --disable-build-servers, --no-cache, and -sc|--self-contained to the command syntax
  • Options section: Updated --launch-profile to show the -lp shortcut

All options were already documented in the Options section (either directly or via include files) but were missing from the Synopsis, creating a discrepancy between the documentation and actual command behavior.

dotnet run [<applicationArguments>]
  [-a|--arch <ARCHITECTURE>] [--artifacts-path <ARTIFACTS_DIR>]
  [-c|--configuration <CONFIGURATION>] [--disable-build-servers]
  [-e|--environment <KEY=VALUE>] [--file <FILE_PATH>]
  [-f|--framework <FRAMEWORK>] [--force] [--interactive]
  [-lp|--launch-profile <NAME>] [--no-build] [--no-cache]
  [--no-dependencies] [--no-launch-profile] [--no-restore] [--os <OS>]
  [--project <PATH>] [-r|--runtime <RUNTIME_IDENTIFIER>]
  [-sc|--self-contained] [--tl:[auto|on|off]] [-v|--verbosity <LEVEL>]
  [[--] [application arguments]]
Original prompt

This section details on the original issue you should resolve

<issue_title>Missing shortcut for launch profile (-lp <NAME>) ... and a few other options</issue_title>
<issue_description>### Type of issue

Missing information

Description

Missing -lp shortcut for the launch profile.

Also not present per dotnet run -h

  • --artifacts-path <ARTIFACTS_DIR>: The artifacts path. All output from the project, including build, publish, and pack output, will go in subfolders under the specified path.
  • --disable-build-servers: Force the command to ignore any persistent build servers. [default: False]
  • --no-cache: Skip up to date checks and always build the program before running. [default: False]
  • --sc|--self-contained: Publish the .NET runtime with your application so the runtime doesn't need to be installed on the target machine. The default is 'false.' However, when targeting .NET 7 or lower, the default is 'true' if a runtime identifier is specified. [default: False]

Page URL

https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-run

Content source URL

https://github.com/dotnet/docs/blob/main/docs/core/tools/dotnet-run.md

Document Version Independent Id

7e78f9f5-f77c-828d-ef76-8ef8593d5803

Platform Id

a7c8b306-df1b-bfae-f387-a4da37ef26ca

Article author

@adegeo

Metadata

  • ID: fd3f4227-cd9b-7b1c-7e1b-ffb3d42ae496
  • PlatformId: a7c8b306-df1b-bfae-f387-a4da37ef26ca
  • Service: dotnet-fundamentals

Related Issues</issue_description>

<agent_instructions>Add the missing options specified in the issue description to both the Synopsis and Options section so that they have the complete set of options.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Internal previews

📄 File 🔗 Preview link
docs/core/tools/dotnet-run.md dotnet run

@meaghanlewis
Add missing options to dotnet-run.md Synopsis and update launch-profi…
d5037d5 
…le with -lp shortcut

Co-authored-by: meaghanlewis <10103121+meaghanlewis@users.noreply.github.com>
Copilot AI changed the title [WIP] Add missing shortcut for launch profile option Add missing options to dotnet run command documentation Jan 6, 2026
Copilot AI requested a review from meaghanlewis January 6, 2026 19:31
@meaghanlewis meaghanlewis marked this pull request as ready for review January 6, 2026 19:58
@meaghanlewis meaghanlewis requested a review from a team as a code owner January 6, 2026 19:58
Copilot AI review requested due to automatic review settings January 6, 2026 19:58
Copilot AI reviewed Jan 6, 2026
View reviewed changes
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR fixes documentation discrepancies by adding missing options to the dotnet run command Synopsis that were already documented in the Options section but were absent from the command syntax.

  • Added four missing options to the Synopsis section: -lp shortcut for --launch-profile, --disable-build-servers, --no-cache, and -sc|--self-contained
  • Updated the Options section to show the -lp shortcut alongside --launch-profile

@meaghanlewis
Remove extra newline at end of dotnet-run.md
2daf79c 
Add a newline at the end of the dotnet-run.md file.
@meaghanlewis
Fix missing newline at end of dotnet-run.md
52562ac 
Add a newline at the end of the dotnet-run.md file
@meaghanlewis
Remove trailing newline from dotnet-run.md
4a90141
@meaghanlewis meaghanlewis requested a review from adegeo January 6, 2026 23:15
gewarren
gewarren approved these changes Jan 7, 2026
View reviewed changes
Copy link
Contributor

@gewarren gewarren left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess we can/should close #50128?

@meaghanlewis meaghanlewis merged commit 9cf2884 into main Jan 7, 2026
11 checks passed
@meaghanlewis meaghanlewis deleted the copilot/add-launch-profile-shortcut branch January 7, 2026 18:07
@meaghanlewis meaghanlewis mentioned this pull request Jan 7, 2026
Closed
gewarren pushed a commit to gewarren/docs that referenced this pull request Jan 8, 2026
@meaghanlewis @gewarren
Add missing options to dotnet run command documentation (dotnet#50912)
6d9f820 
* Initial plan

* Add missing options to dotnet-run.md Synopsis and update launch-profile with -lp shortcut

Co-authored-by: meaghanlewis <10103121+meaghanlewis@users.noreply.github.com>

* Fix formatting of dotnet run command options

* Remove extra newline at end of dotnet-run.md

Add a newline at the end of the dotnet-run.md file.

* Fix missing newline at end of dotnet-run.md

Add a newline at the end of the dotnet-run.md file

* Remove trailing newline from dotnet-run.md

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: meaghanlewis <10103121+meaghanlewis@users.noreply.github.com>
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

@gewarren gewarren gewarren approved these changes

@adegeo adegeo Awaiting requested review from adegeo

+1 more reviewer

@meaghanlewis meaghanlewis meaghanlewis approved these changes

Reviewers whose approvals may not affect merge requirements

Assignees

@meaghanlewis meaghanlewis

Copilot code review Copilot

Labels

dotnet-cli/subsvc dotnet-fundamentals/svc

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Missing shortcut for launch profile (-lp <NAME>) ... and a few other options

3 participants

@meaghanlewis @gewarren